package cn.iocoder.yudao.module.system.service.gugu;

import cn.iocoder.yudao.module.system.controller.admin.gugu.vo.subjectselection.MajorCategoryListReqVO;
import cn.iocoder.yudao.module.system.controller.admin.gugu.vo.subjectselection.SchoolListReqVO;
import cn.iocoder.yudao.module.system.controller.admin.gugu.vo.subjectselection.SubjectSelectionReqVO;
import cn.iocoder.yudao.module.system.controller.admin.gugu.vo.subjectselection.SubjectSelectionRespVO;

import java.util.List;

/**
 * 选科功能服务接口
 */
public interface SubjectSelectionService {

    /**
     * 获取专业大类列表
     *
     * @param reqVO 查询条件
     * @return 专业大类列表
     */
    List<SubjectSelectionRespVO.MajorCategoryInfo> getMajorCategoryList(MajorCategoryListReqVO reqVO);

    /**
     * 根据选择的专业大类计算最优选科组合
     *
     * @param reqVO 选科请求参数
     * @return 选科结果
     */
    SubjectSelectionRespVO calculateOptimalSubjectCombination(SubjectSelectionReqVO reqVO);

    /**
     * 获取学校列表
     *
     * @param reqVO 查询条件
     * @return 学校列表
     */
    List<SubjectSelectionRespVO.SchoolInfo> getSchoolList(SchoolListReqVO reqVO);

    /**
     * 获取指定专业大类的选科要求统计
     *
     * @param categoryName 专业大类名称
     * @param province 省份
     * @param year 年份
     * @param educationLevel 教育级别
     * @param type 文理综合类别
     * @return 选科要求统计信息
     */
    SubjectSelectionRespVO.MajorCategoryInfo getMajorCategoryInfo(String categoryName, String province,
                                                                  Integer year, String educationLevel, String type);

    /**
     * 获取指定学校的选科要求统计
     *
     * @param schoolName 学校名称
     * @param province 省份
     * @param year 年份
     * @param educationLevel 教育级别
     * @param type 文理综合类别
     * @return 选科要求统计信息
     */
    SubjectSelectionRespVO.SchoolInfo getSchoolInfo(String schoolName, String province,
                                                    Integer year, String educationLevel, String type);
}
